Scenario #9312: Newly Created Account for Existing Natural Person Should Be Able to View Existing Relations

Properties

Required

Given

name value
subjectName xyz-peter.smith

Expected

name value
expectedRelationsJson [
  {
    “type”: “REPRESENTATIVE”,
    “anchor”: { “tradeName”: “Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@secondcontact.example.com” } }
  },
  {
    “type”: “PARTNER”,
    “anchor”: { “tradeName”: “Hostsharing eG” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@sixthcontact.example.com” } }
  },
  {
    “type”: “DEBITOR”,
    “anchor”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@thirdcontact.example.com” } }
  },
  {
    “type”: “SUBSCRIBER”,
    “mark”: “members-announce”,
    “anchor”: { “tradeName”: “Third OHG” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@thirdcontact.example.com” } }
  }
]

personUuid

HTTP GET "/api/hs/accounts/accounts" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "242a0002-0000-0000-0000-000000000002", // Account: xyz-peter.smith
  "person" : {
    "uuid" : "fcf8c7df-4fcf-4869-ab61-f1220590e953", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "subject" : {
    "uuid" : "242a0002-0000-0000-0000-000000000002", // Account: xyz-peter.smith
    "name" : "xyz-peter.smith",
    "organization" : "xyz",
    "type" : "USER"
  },
  "globalUid" : 21011,
  "globalGid" : 21011
} ]

Fetch the account for the current subject to resolve the related person.

View their relations

HTTP GET "/api/hs/office/relations?personUuid=fcf8c7df-4fcf-4869-ab61-f1220590e953" // personUuid \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "a78ab6ba-88cb-4010-b6d1-9d409d464581",
  "anchor" : {
    "uuid" : "81d77669-fb74-4434-b15e-481e17ada98d",
    "personType" : "LEGAL_PERSON",
    "tradeName" : "Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.",
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "holder" : {
    "uuid" : "fcf8c7df-4fcf-4869-ab61-f1220590e953", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "ab23ab66-5b24-44c3-8155-d391b3ff851d",
    "caption" : "second contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@secondcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
}, {
  "uuid" : "ea926bc0-9f51-4505-98c1-6ca6328a6eb2",
  "anchor" : {
    "uuid" : "fcf8c7df-4fcf-4869-ab61-f1220590e953", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "holder" : {
    "uuid" : "fcf8c7df-4fcf-4869-ab61-f1220590e953", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "DEBITOR",
  "mark" : null,
  "contact" : {
    "uuid" : "a967d330-8244-4117-bb66-599dc4367cb0",
    "caption" : "third contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@thirdcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
}, {
  "uuid" : "47e57eed-da04-40b9-8670-9d02f442ba13",
  "anchor" : {
    "uuid" : "cff2d78c-e09b-40e0-915f-d7d4ed492967",
    "personType" : "INCORPORATED_FIRM",
    "tradeName" : "Third OHG",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "fcf8c7df-4fcf-4869-ab61-f1220590e953", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "SUBSCRIBER",
  "mark" : "members-announce",
  "contact" : {
    "uuid" : "a967d330-8244-4117-bb66-599dc4367cb0",
    "caption" : "third contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@thirdcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
}, {
  "uuid" : "9fd45ac7-5cda-4eab-8bde-35cdcb4f29fe",
  "anchor" : {
    "uuid" : "8f6b2e83-5cd0-4f3b-bac9-c56b374445cf",
    "personType" : "LEGAL_PERSON",
    "tradeName" : "Hostsharing eG",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "fcf8c7df-4fcf-4869-ab61-f1220590e953", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "PARTNER",
  "mark" : null,
  "contact" : {
    "uuid" : "989a5415-f2c1-4464-b550-8bd7982883e1",
    "caption" : "sixth contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@sixthcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
} ]

generated on 2026-08-10 03:08:25 for branch HEAD